<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - SelectorList</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu132.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu134.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRSELLIST" ></A>SelectorList</H3>
		<A NAME="IDX686"></A><A NAME="IDX687"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATINT">Interactor</A>
<A NAME="IDX688"></A>
<A NAME="IDX689"></A>
<P><STRONG>Function</STRONG>
<P>
Generates a list of values and a strings based on user input.
<P><STRONG>Syntax</STRONG>
<P>
Available only through the user interface.
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>stringdata</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string list or group
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">no default
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">specifies or derives a list of
potential output strings
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>valuelist</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or string list or value
list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0-based list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">list of potential output values
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>cull</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">flag
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">determines whether zero-length
strings are removed (1) or not (0)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>label</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">&quot;Selector&quot;
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">global name applied to interactor
stand-ins
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>value</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">string or value
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">value
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>name</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">string name
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module allows the user to interactively select zero, one, or
more items from a list.
Through inputs to the module (outputs from other tools or values set
in its configuration dialog box) the interactor can be
"data-driven."
<P>
If the interactor is not data-driven, its attributes are taken from
its <TT><STRONG>Set Attributes...</STRONG></TT> dialog box (accessed
from the <TT><STRONG>Edit</STRONG></TT> pull-down menu
in the Control Panel).
<P>
This interactor requires a list of strings and a list of values or
strings that are then paired up one-to-one and used as
selectable outputs.
The inputs to SelectorList are used to generate both lists.
If there are no inputs, the module uses the values in its <TT><STRONG>Set
Attributes...</STRONG></TT> dialog box.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>stringdata</STRONG></TT>
</B></TD><TD><P>controls the string values that appear as output in
<TT><STRONG>name</STRONG></TT>.
It is required if the interactor is data-driven.
<P>
If the parameter value is:
<UL COMPACT>
<LI><I>a string list:</I> the individual strings are used as
potential outputs.
<LI><I>a group:</I> the names of the group members (or member1,
member2, ...) are used as possible output names.
<LI><I>a series group:</I>  the names are "position =
<I>n</I>," (where <I>n</I> is the series
position of each series member).
</UL>
<P>
In every case, the items in the resulting string list are displayed in
the list of selections in the corresponding SelectorList
interactor.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>valuelist</STRONG></TT>
</B></TD><TD><P>is a list of potential output values.
<P>
If this parameter is a value or string list, these values are mapped
one-to-one onto the string list that results from
<TT><STRONG>stringdata</STRONG></TT> input.
<P>
If the interactor is data-driven, the parameter value can also be a
single integer used to generate a list of integers beginning with
that one.
<P>
If the parameter is defaulted and the interactor is data-driven,
the value list is a list of integers starting at 0 (zero).
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>cull</STRONG></TT>
</B></TD><TD><P>is specified only when the interactor is data-driven.
It determines whether or not empty strings are culled from the string
list that results from <TT><STRONG>stringdata</STRONG></TT> input.
If set to 1, empty strings are removed.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>label</STRONG></TT>
</B></TD><TD><P>is the global label of all instances of the corresponding
interactor
stand-in.
An interactor instance&#39;s local label (set from the Control Panel)
overrides a global label.
If not specified, the global label is set by the user interface.
</TD></TR></TABLE>
<P><STRONG>Example Visual Program</STRONG>
<P>
<PRE>
InterfaceControl3.net
</PRE>
<P><STRONG>See Also</STRONG>
<P>
&nbsp;<A HREF="refgu078.htm#HDRINTEGER">Integer</A>,
&nbsp;<A HREF="refgu079.htm#HDRINTEGEL">IntegerList</A>,
&nbsp;<A HREF="refgu127.htm#HDRSCALAR">Scalar</A>,
&nbsp;<A HREF="refgu128.htm#HDRSCALARL">ScalarList</A>,
&nbsp;<A HREF="refgu169.htm#HDRVECTOR">Vector</A>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
